Tangible Software Solutions

C++ to VB Converter Help


Contents

  1. Folder Conversion
  2. File & Snippet Conversion
  3. Code Formatting Options
  4. Header File Options
  5. System Headers
  6. Library Free Function Replacements
  7. C++ Types to Convert to VB Structures
  8. Conversion Message Options
  9. Custom String Replacements
  10. Type & Member Replacements
  11. Diagnostic Options
  12. File Encoding Options
  13. Additions & Omissions
  14. Miscellaneous Options
  15. Copy Constructors and Copy Assignment


Folder Conversion

The Folder Converter tab allows you to convert all C++ code within a folder. Once the files are converted, you can then view C++ to VB Converter comments, compare converted code files to original code files, and view the converted code folder.

The Conversion History listview displays previously converted sources and allows you to view remaining C++ to VB Converter comments and view the converted code folder.


File & Snippet Conversion

The File & Snippet Converter tab allows you to convert C++ code snippets or files. From the left side textbox, you can type or paste code snippets, insert files, or view C++ to VB Converter sample snippets. Once a file or snippet is converted, you can select and copy the results, save the results to a file, or search the results.


Code Formatting Options


Header File Options


System Headers


C++ Types to Convert to VB Structures

The converter normally converts all C++ classes and structs to VB 'Class' since this is the closest equivalent to the nearly identical C++ 'class' and 'struct'. If pointers are never used on a class or struct and all assigning or construction involving the type is intended to copy the object, then you may wish to specify that the type should be converted to a VB 'Structure'.


Library Free Function Replacements

C++ to VB Converter is primarily a syntax converter, ignoring most calls to C/C++ library 'free' functions (library functions which don't belong to a class or struct). However, you can specify your own custom replacements for these free function calls. These replacements will occur at the end of the conversion process. You specify the new method name, the expected number of arguments, and whether to transform the function call to an instance method call (using one of the arguments as the instance variable), or a static method call (where you specify a class name in addition to the new method name). You can also specify conversion to an instance or static property.


Conversion Message Options

On this options dialog, you can customize the comment prefixes that the converter uses for messages and also toggle the messages that C++ to VB Converter displays on or off.

You can easily set all or none to display via the 'Select All' and 'Select None' buttons.


Custom String Replacements

C++ to VB Converter allows you to specify your own custom replacements in the converted VB code. This can be useful for cases where you wish to specify a replacement for a C++ library data type that isn't handle by C++ to VB Converter.

For each replacement string you can specify the regex option, when to perform the replacement (pre or post conversion), whether or not to match case, whether to match whole words only, and whether comments or string literals should be modified. The whole words and string literals options do not apply if the regex option is selected.

To span mulitple lines, either paste directly into the 'Find' and 'Replacement' textboxes, or use the escaped characters: \r\n\t.

The "Active" checkbox can be unchecked if you wish to temporarily bypass the replacement.

Replacements are made in the order that they appear on the options dialog. For example, the second replacement is made to each line of code after the first replacement has already been made. To change the order of replacements, use the 'Up' and 'Down' buttons.

For an example of the regex option, you could do a custom replacement of "Foo(x)" with "Bar(x)", where "x" is any argument, by specifying the "Find" field as "Foo(([\sa-zA-Z_$]*))" and the "Replace" field as "Bar$1". Note that there are differences in various regex engines - the regex engine used by the converter is .NET System.Text.RegularExpressions.Regex.


Type & Member Replacements

C++ to VB Converter allows you to specify your own custom type and member replacements in the converted code. This can be useful for cases where you wish to specify replacements for C++ library member calls of a specific type that are not handled by C++ to VB Converter.

For each external type, you can specify an optional type replacement and multiple member replacements. For types, you can specify template/generic types, which may include '?' as a wildcard type. A wildcard in the replacement type must have a matching wildcard in the same position in the original type.

e.g., the following will replace all references to type 'Foo' having one 'int' type parameter with 'Bar', having no type parameters:
original type: Foo<int>
replacement type: Bar

e.g., the following will replace all references to type 'Foo' having one type parameter of any type with 'Bar', having the same type parameter:
original type: Foo<?>
replacement type: Bar(Of ?)

For each member replacement, you specify the original member name, whether the member is static or not, and whether the member is a method or a field. You also specify the number of arguments you expect.

For the replacement member, you specify whether the replacement is static or not, and whether the replacement is a method or a field. You also specify the new list of arguments and can add literal arguments. For replacement of static methods with instance members, you also specify the argument position which corresponds to the object instance for the new instance member. For replacement of instance members with static members, you specify the new class name used to call the static member (for static methods, you also specify the position in the argument list to insert the previous instance qualifier, using the string "instance" (quotes not included) at the appropriate position in the "new argument list" field). For example, if you want to replace all instance calls to the 'Foo' type method 'Bar' where you want the instance qualifier to be the new first argument, you would specify "instance, a1" (quotes not included) for the "new argument list" field, assuming that there was one argument in the original method calls.


Diagnostic Options

These options are intended to provide information to Tangible Software Solutions if a conversion is taking longer than expected. 'Record processing by file' instructs the converter to make a record of the files processed and the time taken for each process. 'Record the last 100 lines of code parsed before cancelling conversion' instructs the converter to make a record of the most recent lines parsed before you cancelled the conversion.


File Encoding Options

The converter detects input file encoding from the byte order mark (BOM), but if the BOM is missing the converter assumes by default that the file encoding is UTF-8. You can use this option to specify a different default encoding to use in the absence of a BOM. Output is written in the same encoding as the encoding detected for the original file, or your default encoding option if the original coding was not detected via the BOM. For UTF-8, you can choose whether or not to include the BOM for the output - this is normally used in Windows environments.


Additions & Omissions


Miscellaneous Options


Copy Constructors and Copy Assignment

In C++, object variable assignment without using pointers does not perform reference assignment as in VB. Instead these assignments perform a bitwise copy by default or performs the action specified in a copy constructor or assignment operator overload specified in the C++ source code. When C++ to VB Converter determines that an assignment is likely a copy assignment or a call to a copy constructor, it converts them to the VB equivalent and adds a warning to the converted code.

e.g., the following C++ code:
Foo g;
Foo f = g; //uses the copy constructor of type 'Foo'
f = g; //uses the assignment operator overload of type 'Foo'

converts to the VB equivalent:
Dim g As New Foo()
Dim f As New Foo(g)
f.CopyFrom(g)

The original copy constructor is converted directly to a VB constructor, and the original assignment operator overload is converted to a 'CopyFrom' method (since overloading the assignment operator is not possible in VB). C++ compilers automatically generate both the copy constructor and the assignment operator overload if one isn't specified in the C++ source code, but C++ to VB Converter will only convert existing copy constructors and assignment operator overloads and will not create default methods. You may need to code the copy constructor and/or the 'CopyFrom' method if the original C++ source code relied on the default methods created by the C++ compiler.


Copyright © Tangible Software Solutions, Inc.